.. |kIRed_ic| image:: Img/qIRed.png .. |kOtm_ic| image:: Img/qOtm.png .. |kShrift_ic| image:: Img/qShrift.png .. |kStr_ic| image:: Img/qStr.png .. |kSpis_ic| image:: Img/qSpis.png .. |kZit_ic| image:: Img/qZit.png .. |kInte_ic| image:: Img/qInte.png .. |kWik_ic| image:: Img/qWik.png .. |kIso_ic| image:: Img/qIso.png .. |kTab_ic| image:: Img/qTab.png .. |kLin_ic| image:: Img/qLin.png .. |kOchis_ic| image:: Img/qOchis.png .. |kRasv_ic| image:: Img/kRasv.png .. |kSv_ic| image:: Img/kSv.png .. |kSvRasv_ic| image:: Img/kSvRasv.png .. |kZOtch_ic| image:: Img/kZOtch.png .. |kiKale_ic| image:: Img/kiKale.png .. |kiChas_ic| image:: Img/kiChas.png .. |kiOchis_ic| image:: Img/kiOchis.png .. |kIKalegod_ic| image:: Img/kIKalegod.png .. |kiTekVr_ic| image:: Img/kiTekVr.png .. |usSpec_ic| image:: Img/usSpec.png .. |usSled_ic| image:: Img/usSled.png .. |usNaz_ic| image:: Img/usNaz.png .. |usStre_ic| image:: Img/usStre.png .. |usOSp_ic| image:: Img/usOSp.png .. |form_use_markdown_icon_ic| image:: Img/form_use_markdown_icon_ic.png ############################### Руководство по работе с формой. ############################### ************************************** Работа с элементами управления формой. ************************************** В Системе форма содержит следующие элементы управления: * `Элемент управления Кнопка`_. * `Элемент управления Флаг`_. * `Элемент управления Переключатель`_. * `Элемент управления Стрелка`_. * `Значок очистки значения поля`_. .. _Элемент управления Кнопка: **Элемент управления «Кнопка».** Элемент управления «Кнопка» (button) является очень важным элементом формы, поскольку именно с кнопками связаны различные действия, выполняемые пользователем в приложении (сохранение введенных данных, вызов другой формы, отмена действий и т. д.). Обычно кнопка выбирается, когда пользователь щелкает по ней мышью. Однако можно выбрать (нажать, т. к. визуально это именно так и выглядит) кнопку, используя только клавиатуру. Для этого нужно поместить на нее фокус, т. е. сделать активной, нажимая клавишу <Таb>, а затем нажать клавишу . Для этой же цели можно назначить кнопке специальную комбинацию клавиш. Для назначения кнопке специальной комбинации клавиш необходимо обратиться к Администратору Системы. В качестве примера можно привести форму *Вызов врача* в *Каталоге услуг* (:numref:`7Pic1d`). .. _7Pic1d: .. figure:: Img/kKnop.png :scale: 80 % :align: center *Использование кнопок в форме* Здесь кнопка *ОТПРАВИТЬ* позволяет провести отправку данных из заполненной формы, а кнопка *ОТМЕНИТЬ* - закрыть форму ввода данных без сохранения изменений. .. _Элемент управления Флаг: **Элемент управления «Флаг».** Флаг, флаговая кнопка, чекбокс (от англ. check box), галочка — элемент графического пользовательского интерфейса, позволяющий пользователю управлять параметром с двумя состояниями — ☑ включено и ☐ отключено. Во включённом состоянии внутри чекбокса отображается отметка (галочка (✓), или реже крестик(×)). По традиции флажок имеет квадратную форму. Рядом с флажком отображается его обозначение, обычно — подпись, реже — значок. Для увеличения площади активного элемента обычно одинаково реагирует на нажатие мышью как на сам флажок, так и на подпись к нему. В качестве примера можно привести форму *Редактор форм* (:numref:`7Pic2d`). .. _7Pic2d: .. figure:: Img/kRedF.png :scale: 80 % :align: center *Выбор состояния записи в "Редакторе форм"* Здесь включенным флагом ☑ определяются активные записи, с которыми возможно проводить действия. Записи с отключенным флагом останутся неактивными и действия с ними проводиться не будут. .. _Элемент управления Переключатель: **Элемент управления «Переключатель».** Переключатель (toggle) - это элемент управления, который пользователь может включить или отключить. Элемент управления «Переключатель» работает так же, как «Флаг». Так, при редактировании формы отключенный переключатель позволяет сделать невидимым вводимый компонент (:numref:`7Pic3d`). Как следствие, при использовании формы компонент не будет отображаться. .. _7Pic3d: .. figure:: Img/kTVik.png :scale: 80 % :align: center *Состояние переключателя - "Выключено"* Включенный переключатель позволяет отобразить компонент при использовании формы (:numref:`7Pic4d`). .. _7Pic4d: .. figure:: Img/kTVkl.png :scale: 80 % :align: center *Состояние переключателя - "Включено"* .. _Элемент управления Стрелка: **Элемент управления «Стрелка».** * Стрелки развертывания/свертывания формы. Стрелки развертывания/свертывания формы используются для представления формы в развернутом |kRasv_ic| или свернутом |kSv_ic| виде. Пример свернутой формы представлен на рисунке (:numref:`7Pic5d`) .. _7Pic5d: .. figure:: Img/kSvForm.png :scale: 80 % :align: center *Свернутые формы* Пример развернутой формы представлен на рисунке (:numref:`7Pic6d`) .. _7Pic6d: .. figure:: Img/kRasvForm.png :scale: 80 % :align: center *Развернутые формы* * Стрелка развертывания/свертывания списка. Стрелка развертывания/свертывания списка |kSvRasv_ic| предназначена для развертывания/свертывания списка возможных значений поля. При нажатии стрелки |kSvRasv_ic| на свернутом списке (:numref:`7Pic7d`) происходит его раскрытие и с помощью левого клика мыши становится возможным выбор значения поля из списка значений по умолчанию (:numref:`7Pic8d`). .. _7Pic7d: .. figure:: Img/kSvSpi.png :scale: 80 % :align: center *Свернутый список* .. _7Pic8d: .. figure:: Img/kRasvSpi.png :scale: 80 % :align: center *Развернутый список* .. _Значок очистки значения поля: **Значок очистки значения поля.** При левом клике мыши на значок очистки значения поля |kZOtch_ic| происходит удаление значение поля (:numref:`7Pic9d`) и (:numref:`7Pic10d`). .. _7Pic9d: .. figure:: Img/kOtch.png :scale: 80 % :align: center *Поле со значением* .. _7Pic10d: .. figure:: Img/kOtchPo.png :scale: 80 % :align: center *Очищенное значение поля* ********************** Работа с полями формы. ********************** В Системе форма содержит следующие поля ввода данных: * `Поле ввода Дата Время`_. * `Текстовые поля`_. * `Поле markdown`_. * `Числовые поля`_. .. _Поле ввода Дата Время: ================================================ **Поле ввода Дата/Время.** ================================================ Элемент интерфейса позволяет осуществлять ввод даты и времени, представленные в машиночитаемом формате. Он может быть полезен для создания расписаний, архивов или других функций, связанных со временем (:numref:`7Pic11dd`). .. _7Pic11dd: .. figure:: Img/kDat.png :scale: 80 % :align: center *Поле ввода Дата/Время* Поле ввода Дата/Время содержит следующие элементы управления: иконка ввода даты, иконка ввода времени, позволяющие выбрать дату и время, и поле, в котором отображаются выбранные дата и время. При левом клике мыши по кнопке установки даты |kiKale_ic| происходит открытие календаря (:numref:`7Pic12dd`). .. _7Pic12dd: .. figure:: Img/kDatKalen.png :scale: 80 % :align: center *Календарь* Выбор даты осуществляется с помощью левого клика мыши. При нажатии на иконку |kIKalegod_ic| "Список годов" можно переключиться на форму списка выбора года (:numref:`7Pic13dd`). .. _7Pic13dd: .. figure:: Img/kKalegod.png :scale: 80 % :align: center *Форма списка годов* Возврат в форму календаря происходит при левом клике мыши по кнопке "Возврат в календарь" (:numref:`7Pic13dd`). После заполнения поля "Дата/Время" значением даты в поле появляются иконки очистки поля |kiOchis_ic| и ввода времени |kiChas_ic| (:numref:`7Pic13da`). .. _7Pic13da: .. figure:: Img/khis.png :scale: 80 % :align: center *Заполненное поле* Левый клик мыши по иконке очистки поля |kiOchis_ic| позволяет удалить введенные данные и очистить поле. Левый клик мыши по иконке ввода времени |kiChas_ic| открывает форму ввода времени. .. _7Pic14dd: .. figure:: Img/kDatVrem.png :scale: 80 % :align: center *Форма ввода времени* Часы и минуты устанавливаются с помощью перемещения бегунка в соответствующем поле нажатой и удерживаемой левой клавишей мыши. Нажатие кнопки "Установка текущего времени" |kiTekVr_ic| позволяет установить текущее системное время. .. _Текстовые поля: ================================================ **Текстовые поля.** ================================================ Текстовые поля предназначены для ввода простого текста (:numref:`7Pic15dd`). .. _7Pic15dd: .. figure:: Img/kText.png :scale: 80 % :align: center *Текстовое поле* После заполнения поля справа появляется значок |kZOtch_ic|, при нажатии на который левой кнопкой мыши происходит очистка значения поля (:numref:`7Pic16dd`). .. _7Pic16dd: .. figure:: Img/kZText.png :scale: 80 % :align: center *Очистка текстового поля* .. _Поле markdown: ================================================ **Поле markdown.** ================================================ Поле Markdown это поле типа rich-text. Rich-text поле используется в формах для обработки и хранения форматированного текста , например для описания запроса, в формате языка разметки Markdown. Markdown – облегченный язык разметки, созданный для написания, чтения, оформления веб-текстов. Для создания описания в поле формы *Описание запроса* (:numref:`7Pic17d`) следует нажать на символ |kIRed_ic|, после чего откроется редактор Markdown (:numref:`7Pic18d`). .. _7Pic17d: .. figure:: Img/kZapr.png :scale: 80 % :align: center *Поле Описание запроса* .. _7Pic18d: .. figure:: Img/kRedakt.png :scale: 80 % :align: center *Редактор Markdown* Далее следует ввести в редакторе Markdown описание запроса в формате языка разметки Markdown. В редакторе существует следующая система управления: Кнопки |kOtm_ic| позволяют отменить последние действия. Кнопка *Стиль заголовка* с всплывающим списком позволяет выбрать один из шести стилей заголовка (:numref:`7Pic19d`). .. _7Pic19d: .. figure:: Img/kStil.png :scale: 80 % :align: center *Кнопка *Стиль заголовка** Кнопки |kShrift_ic| позволяют выбрать стиль шрифта. Кнопка |kStr_ic| позволяет вводить строчный код. Кнопки |kSpis_ic| позволяю вводить ненумерованный и нумерованный список. Кнопка |kZit_ic| позволяет выделить текст как цитату. Кнопка |kInte_ic| позволяет вставлять ссылки на страницы в интернете. Кнопка |kWik_ic| позволяет добавлять wiki-ссылки. Адрес ссылки вставляется автоматом и берется либо из параметров формы, либо из глобальных настроек. Кнопка |usSpec_ic| позволяет вставить в текст спецсимвол. Спецсимволы – это набор последовательностей, которые заменяют запрещенные для ввода с клавиатуры символы. При нажатии на кнопку |usSpec_ic| открывается форма ввода спецсимволов (:numref:`7Pic19ue`). .. _7Pic19ue: .. figure:: Img/usTabsI.png :scale: 80 % :align: center *Форма выбора спецсимвола* Выбор спецсимвола производится левым кликом мыши по иконке спецсимвола, после чего он отобразится в поле **Выбран символ**. Вставка спецсимвола в текст происходит при нажатии кнопки **ОК** в правом нижнем углу формы. При нажатии кнопки **ОТМЕНА** в правом нижнем углу формы происходит закрытие формы без вставки символа (:numref:`7Pic19ue`). Навигация по листам с иконками спецсимволов производится с помощью кнопок |usSled_ic| и |usNaz_ic| (:numref:`7Pic19ue`). После выбора спецсимвола в поле **Чарт символа** отображается имя блока кодировки. Блок кодировки так же возможно выбрать с помощью стрелки |usStre_ic| в правой части поля **Чарт символа**. Кнопка |usOSp_ic| позволяет перейти из блока кодировки Halfwidth and Fullwidth Forms в блок кодировки Specials (:numref:`7Pic19ue`). Подробную информацию по спецсимволам можно получить по ссылке https://unicode-table.com/ru/. Кнопка |kIso_ic| позволяет добавить файл рисунка. Кнопка |kLin_ic| позволяет добавить горизонтальную линию. Кнопка |kTab_ic| позволяет добавить таблицу. Кнопка |form_use_markdown_icon_ic| позволяет добавить иконку из приложения в поле. Кнопка |kOchis_ic| в правом верхнем углу редактора позволяет очистить поле редактирования. Подробную информацию о языке разметки Markdown можно получить по ссылкам: https://www.markdownguide.org/extended-syntax/ https://texterra.ru/blog/ischerpyvayushchaya-shpargalka-po-sintaksisu-razmetki-markdown-na-zametku-avtoram-veb-razrabotchikam.html ================================================ **Автозаполнение полей.** ================================================ Автозаполнение полей - при выборе одного параметра происходит автоматическое заполнение одного или нескольких полей (:numref:`7Pic20d`). .. _7Pic20d: .. figure:: Img/kSZap.png :scale: 80 % :align: center *Выбор параметра при автозаполнении* При выборе одного из флагов параметров заполнения (:numref:`7Pic20d`) (левый клик мыши) производится автоматическое заполнение полей в панели "Свернутые поля для заполнения" (:numref:`7Pic21d`). .. _7Pic21d: .. figure:: Img/kSZapol.png :scale: 80 % :align: center *Автозаполненные поля* .. _Числовые поля: **Числовые поля.** Числовые поля - это поля для ввода числовых значений. Поле позволяет ввести в форму целочисленные данные или данные с плавающей точкой (:numref:`7Pic22d`). .. _7Pic22d: .. figure:: Img/kChis.png :scale: 80 % :align: center *Числовое поле*